﻿
                
  
                            PIVATE SECURITY SERVICE

                                    By WTLS




ABOUT THIS TXT:

This txt content:
- Description,
- Requirements,
- Known issues and their solutions,
- Main installation,
- How to use,
- Changelog,
- Credits,
- Notes.





DESCRIPTION:

SecuroServ is a private security organization and a feature in GTA Online.
It is supposed to provide with VIP transporting using armored vehicles 
with armed and trained bodyguards. In fact we have never seen this in GTA 
Online. The only thing that exists is to hire online players as workers 
and ask them to do this job for you. LOL.
This mod brings this missing security service to the game. A service that 
allows you to have bodyguards that transport you and protect you from 
attackers.
Features:
- 2 levels of protection: Standard VIP, Standard VIP+.
- 3 different protection modes: Normal, Safe Mode and Fast Mode. Safe 
Mode is when bodyguards are more focused on safety, howerever in the Fast Mode 
bodyguards are more focused on arriving to the destination as soon as possible.
- SecuroServ phone contact.
- SecuroServ level selection and options menu.
- SecuroServ orders menu with lot of options.
- Vehicle renting,
- You can go to the center of SecuroServ or call the service using the menu.
- Go to waypoint or cruise.
- Backup system, you can call backup.
- Replace a bodyguard with a backup unit if dead.
- Replace the limousine with backup vehicle if damaged or 
destroyed.
- Police friendly.
- Police system, police call when no backup left.
- Limousine doors locked when player is in it. No one can open the doors.
- Healing after entering the limo.
- a cost to pay.
- Bodyguards follow player also on foot.
- Security group follows player's personal vehicle.
- Vehicles have police horn.
- Chrome wheel rims.
- Tinted windows.
- Upgraded engine, transmission and brakes.
- Hazard lights.
- Hints.
- Map blips.
- Custom vehicle models.
- Ini file customization.
- Compatibility with Private Flight Service.
- Controller support.








REQUIREMENTS:

ScriptHookV
ScriptHookVDotNet
NativeUI (included)
iFruitAddon2 (included)





KNOWN ISSUES AND SOLUTIONS:

- Vehicles sometimes not driving correctly, like hitting other vehicles.
> This happens mostly in the Fast Mode. This is how it is the AI in GTA5. Nothing we can do about it. Use switching between modes Normal, Fast and Safe Mode.

- A following vehicle is blocked in somewhere.
> Leave it and it will respawns correctly.

- Limo doesn't want to stop and drives fast even not in Fast Mode.
> This happens when there is a threat. Enable Auto Safe Mode and set Survival behaviour to "Fight" in the orders menu to make the limo stops instead of running away.

- Group doesn't move after spawned.
> Customize SPAWNDISTANCE in the settings file or go to SecuroServ Center.

- Player character wraps out after entering the limo.
> This happens with DLC vehicles. There is an algorithm in the game that prevents using DLC vehicles in story mode. Use a mod that disables this thing. We recommand Simple Trainer by sjaak327, link: https://www.gta5-mods.com/scripts/simple-trainer-for-gtav

- Other?
> Report on #bugs-report channel on discord server. If it's a script error, include the text inside "ScriptHookVDotNet.txt" file in GTA5 main directory.






INSTALLATION:

Put "PrivateSecurityService.dll", "PrivateSecurityService.ini", "PSSNotifictions.dll", "NativeUI.dll" and "iFruitAddon2.dll" files and "PrivateSecurityService" folder!!! in "scripts" folder.

This is Highly highly recommanded with Advanced VIP and Elite VIP: Armored VIP Transporter Pack (link: https://de.gta5-mods.com/vehicles/armored-vehicles-vip-transporter-pack-add-on ). It makes vehicles have strobe lights. Strobe lights make traffic cars allowing security group to pass them like police siren. 
After installing Armored VIP Transporter Pack if the strobe lights doesn't work or they're in the wrong place, use SirenSetting Limit Adjuster (link: https://www.gta5-mods.com/scripts/sirensetting-limit-adjuster ). If the game crashes during the loading screen, use Gameconfig (link: https://www.gta5-mods.com/misc/gta-5-gameconfig-300-cars ).
After installing Armored VIP Transporter Pack open OpenIV and click tools then package installer then choose the downloaded "PSS_SL.oiv" OR right clic the downloaded "PSS_SL.oiv" and open with OpenIV, install in "Mods" folder.





HOW TO USE:

Call SecuroServ using the phone for a menu to pop up. The menu is self-explainatory.
After ordering a security service the group will come to your location. A blip will apear on the map indicating the location of the comming limo.
If you don't want to wait for the group to come to your location, you can go yourself to the center of SecuroServ. You know its location by a blip of SecuroServ in the map.
You pay the service by hours.
Press your default enter vehicle key to enter the limo as passenger.
Press context to go to a waypoint or just cruise. Press context to stop.
Call SecuroServ for thr orders menu to pop up. The menu is self-explainatory.
The backup automatically called if a bodyguard is dead or the limo or other vehicle is damaged or destroyed.
Ini file customization:
ENABLEKEYS enable using keys to open the menu, change mode and call backup.
MENUKEY, CHANGEMODEKEY and CALLBACKUPKEY are keys used for each command.
SPEED and DRIVINGSTYLE are settings of the normal mode.
SPAWNDISTANCE how far the security group will spawn.
STANDARDVIPPRICE and STANDARDVIPPLUSPRICE are the hourly prices of each level.
LIMOMODEL1 is the limousine and backup cars of Standard VIP(+) level. 
POLICECARMODEL is the police car.





CHANGELOG:

4.0:
- Added new menu UI images,
- Added option to call a quick service of security assist (Emergency call),
- Added option to order bodyguards only (without convoy),
- Added vehicle renting,
- Added backup setting (option to choose when exactly to call backup),
- Added option to be as driver in the convoy,
- Added option to go to LSIA without route bugs,
- Added option to task bodyguards to be in your personal vehicle while the other cars are following you,
- Added choosing vehicle models to use in the security convoy, 
- Added weapons attachements like grip, scope and flashlight,
- Added radio in the limousine as passenger,
- Fixed personal vehicle follow not working sometimes,
- Fixed backup units don't fight against melee attackers,
- Fixed sometimes not all bodyguards despawn after finishing the service,
- Fixed FPS after finishing service,
- Improved menu UI,
- Improved bodyguards alertness,
- Improved fight strategy settings,
- Removed text from tires,
- Removed options in the main menu,
- Now AVTP is detected automatically,
- Other fixes and improvements.

3.1.2:
- Fixed error after getting notification.

3.1:
- Added option to toggle auto backup,
- Fixed personal vehicle follow not working,
- Fixed driver flee when only an NPC insults,
- Fixed phone doesn't hang out,
- Improved speed of personal vehicle follow,
- Improved notifications,
- Other improvements.

3.0.3:
- Improved peds variety.

3.0.1:
- Added SecuroServ phone contact.
- Added the orders menu.
- Added options menu to change Limousine model.
- Added compatibility with Private Flight Service.
- Added spawn distance as an option in the ine file.
- Added Fight or Flight survival behaviors.
- Added fight strategy offensive/defensive. 
- Added keys optional.
- Added controller support.
- Changed levels selection menu style.
- Changed riding controls.
- Upgraded weapons.
- Fixed fighting ability.
- Fixed NullReferenceException error.
- Fixed security group despawns after leaving SecuroServ Center.
- Fixed backup/police can be called only one time bug.
- Fixed backup/police cause damage when arriving (hits other vehicles).
- Fixed backup/police fight againt bodyguards sometimes.
- Fixed backup/police arrives to wrong place sometimes.
- Fixed blips bugs.
- Fixed one bodyguard doesn't fight in Standard VIP+.
- Fixed fight between bodyguards after finishing service.
- Fixed peds and vehicles stay persistent after finishing service.
- Fixed bodyguards stay outside vehicles after neutralizing a threat.
- Other fixes and improvements.

2.1:
- Added SecuroServ Center (beta).
- Added custom vehicle models.
- Added calling police when no backup left.
- Added healing when in limo.
- Improved vehicle paints.
- Removed SecuroServ icon from notifications (SHVDN bug).
- Many other improvements and fixes.
- Canceled Custom VIP level.

2.0.1:
- Added SecuroServ notifications.
- Some fixes.

2.0:
- rewrote a lot of things in the script.
- added follow personal vehicle.
- added tinted windows, chrome tires and vehicle performance upgrade.
- added police horns.
- added hazard lights.
- added custom prices.
- added auto safe mode option.
- fixed menu instantally closes.
- fixed limousine driver flee in attack situation.
- fixed bodyguards don't enter vehicle sometimes.
- fixed some blips still after canceling service.
- improved bodyguards heath, armour and combat abilities.
- improved hints.
- improved bodyguards and vehicles replacing.
- a lot of other fixes.


1.0 beta:
- first release.





CREDITS:

Alexander Blade,
Crosire,
Nachtfliege,
Jacobmaate,
SAS994.




NOTES!:

You are NOT authorized to reupload in anywhere or to give to anyone!

Enjoy!

                                        WTLS 2026